Sourced from caffeine's releases.

3.0.0

This release includes API incompatible changes.

Highlights

• Java 11 or above is required

Improvements

• Refresh operations ignore redundant calls during an in-flight load and are linearizable(#193, #236, #282, #322, #373, #467)
• The Java Platform Logging API is used instead of java.util.logging (#456)
• CacheLoader and AsyncCacheLoader offer bulk factory methods
• AsyncCacheLoader methods may now throw checked exceptions
• Better usage of Checker Framework nullness annotations (#337)
• More flexible generic bounds and type parameters
• sun.misc.Unsafe is no longer required (#273)

Incompatible changes

• VarExpiration time-based puts now return the old value instead of a boolean result
• Added Policy.refreshes() for a snapshot of the in-flight refresh operations
• LoadingCache.refresh now returns the in-flight future (#143)
• Removed jandex resource as no longer utilized by Quarkus
• Split Policy.Expiration into fixed and refresh interfaces
• Various unimplemented default methods are now abstract
• Added LoadingCache.refreshAll convenience method
• Bulk loads now receive a Set of keys (was Iterable)

Deprecation removals

• CacheWriter, SingleConsumerQueue, and UnsafeAccess
• StatsCounter.recordEviction variations
• CacheStats constructors

Notes

• CacheWriter usages can be replaced by Map computations and Caffeine.evictionListener
• For best performance Unsafe may be used if available, otherwise falls back to VarHandles

2.9.0

Cache

• Added Caffeine.evictionListener which is notified within the atomic operation when an entry is automatically removed
• Added triggering cache maintenance if an iterator observes an expired entry for more aggressive eviction (#487)
• Improved eager eviction of an added or updated entry if it exceeds the cache's maximum weight
• Deprecated CacheWriter. Please use asMap computations or an eviction listener instead
• Added CacheStats.of(...) to allow for becoming a value-based class in a future release

• be6ad63 add checkerframework javadoc link
• a95ae26 Added snapshot view of in-flight refresh operations
• 0d23987 misc improvements (javadoc, generics, build)
• b45b1cc Add refreshAll(keys) convenience method (bulk not supported)
• b792cc3 Split the release workflow out from the build action
• 16ddc49 Update version to 3.0.0
• 28a456e Remove CacheWriter (deprecated for removal in v2.9)
• e1b3bca Remove jandex as unused
• a0c310c Prefer VarHandle for ring buffer array
• d63c871 Mirror usage of @CheckReturnValue from Guava
• Additional commits viewable in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)